<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- The HTML 4.01 Transitional DOCTYPE declaration-->
<!-- above set at the top of the file will set     -->
<!-- the browser's rendering engine into           -->
<!-- "Quirks Mode". Replacing this declaration     -->
<!-- with a "Standards Mode" doctype is supported, -->
<!-- but may lead to some differences in layout.   -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
<html>
	<font face="Verdana">
	<head>
	<title>Event Search API</title>
	</head>
	<body>
		<h1>Event Search API</h1>
		Der Service "Event Search" sucht bei folgenden Quellen nach Events:
		<br/>
		Facebook: <a href="http://www.facebook.com/">http://www.facebook.com/</a>
		<br/>
		Eventful: <a href="http://eventful.com/">http://eventful.com/</a>
		<br/>
		Upcoming: <a href="http://upcoming.yahoo.com/">http://upcoming.yahoo.com/</a>


		<h2>URL zum Sammelservice: http://kit-services.appspot.com/event?param1=.....&param2=..... ....</h2>
		Mögliche Parameter:
		<table border=1>
			<tr>
				<th>Parameter</th>
				<th>Datentyp</th>
				<th>Wertebereich</th>
				<th>Beschreibung</th>
				<th>Default</th>
				<th>Typ</th>
			</tr>
			<tr>
				<td>query</td>
				<td>String</td>
				<td>gültiges String-Literal</td>
				<td>Suchstring</td>
				<td></td>
				<td>muss</td>
			</tr>
			<tr>
				<td>limit</td>
				<td>Integer</td>
				<td>&gt;0</td>
				<td>Beschränkt die Anzahl der Events, die bei jeder Quelle angefragt werden</td>
				<td>20</td>
				<td>optional</td>
			</tr>
			<tr>
				<td>source</td>
				<td>String</td>
				<td>facebook, eventful, upcoming</td>
				<td>Definition der angefragten Quellen</td>
				<td>Ist der Parameter nicht angegeben, werden alle Quellen angefragt</td>
				<td>optional, der Parameter kann mehrmals verwendet werden (wenn mehrere Quellen angefragt werden sollen)</td>
			</tr>
			<tr>
				<td>format</td>
				<td>String</td>
				<td>rdf, kml, map, table</td>
				<td>Auswahl des MIME-Types. Zur Beschreibung der MIME-Types siehe Output-Beschreibung</td>
				<td>Bei nicht gesetztem Parameter wird der Accept-Header des Requests ausgewertet. </td>
				<td>optional</td>
			</tr>
		</table>
		
		
		<h3>Beispiele</h3>
		Anzeige der Hauptseite
		<br/>
		<a href="http://kit-services.appspot.com/">http://kit-services.appspot.com/</a>
		<br/>
		Suche auf Facebook und Upcoming nach "flashmob" mit dem Limit 200 und Ausgabe als Tabelle
		<br/>
		<a href="http://kit-services.appspot.com/event?format=table&amp;query=flashmob&amp;limit=50&amp;source=facebook&amp;source=upcoming">http://kit-services.appspot.com/event?format=table&amp;query=flashmob&amp;limit=200&amp;source=facebook&amp;source=upcoming</a>
		<br/>
		Alle Quellen, Default-Limit, Content-Type über Content-Negotiation
		<br/>
		<a href="http://kit-services.appspot.com/event?query=Party+Karlsruhe">http://kit-services.appspot.com/event?query=Fette+Party+Karlsruhe</a>
		<br/>
		
				
		<h2>URL für die atomaren Services: http://kit-services.appspot.com/{Quelle}...</h2>
		"Einzelservices", die nur bei der angegebenen Quelle anfragen und die Events unabhängig vom Accept-Header als RDF zurück geben (Wrapper-Services). 
		Für {Quelle} kann ein Wert aus dem Wertebereich des Parameters "source" (facebook, eventful, upcoming) angegeben werden.
		
		
		<br/>
		<table border=1>
			<tr>
				<th>Parameter</th>
				<th>Datentyp</th>
				<th>Wertebereich</th>
				<th>Beschreibung</th>
				<th>Default</th>
				<th>Typ</th>
			</tr>
			<tr>
				<td>query</td>
				<td>String</td>
				<td>gültiges String-Literal</td>
				<td>Suchstring</td>
				<td></td>
				<td>muss</td>
			</tr>
			<tr>
				<td>limit</td>
				<td>Integer</td>
				<td>&gt;0</td>
				<td>Beschränkt die Anzahl der Events, die bei jeder Quelle angefragt werden</td>
				<td>20</td>
				<td>optional</td>
			</tr>
		</table>
		<h3>Beispiele</h3>
	 
		Anfragen an einzelne Quellen, Rückgabe von RDF-XML
		<br/>
		<a href="http://kit-services.appspot.com/facebook?query=eichhorn&amp;limit=100 ">http://kit-services.appspot.com/facebook?query=eichhorn&amp;limit=100 </a>
		<br/>
		<a href="http://kit-services.appspot.com/eventful?query=superbowl">http://kit-services.appspot.com/eventful?query=superbowl</a>
		<br/>
		<a href="http://kit-services.appspot.com/upcoming?query=jazz">http://kit-services.appspot.com/upcoming?query=jazz</a>
		<br/>

		<h2>Ausgabeformate</h2>
		Falls der Parameter "format" angegeben ist, wird er übernommen, ansonsten erfolgt Auswahl des content-types über content negotiation. 
		<table border=1>
			<tr>
				<th>format</th>
				<th>MIME-Type</th>
				<th>Beschreibung</th>
				<th>Externer Link</th>
			</tr>
			<tr>
				<td>rdf</td>
				<td>application/rdf+xml</td>
				<td>Ausgabe in RDF (XML). Als Schema wird LODE (Ontology for Linking Open Description of Events) verwendet. </td>
				<td><a href="http://linkedevents.org/ontology/">http://linkedevents.org/ontology/</a></td>
			</tr>
			<tr>
				<td>table</td>
				<td>text/xml</td>
				<td>Ausgabe des RDF-XML-Dokuments als Tabelle (HTML). Realisierung mittels XSL-Stylesheet, welches dem Browser eine Darstellung des XML-Files als Tabelle ermöglicht.</td>
				<td></td>
			</tr>
			<tr>
				<td>kml</td>
				<td>application/vnd.google-earth.kml+xml</td>
				<td>Ausgabe als KML-File (Keyhole Markup Language).</td>
				<td> <a href="http://www.opengeospatial.org/standards/kml">http://www.opengeospatial.org/standards/kml</a></td>
			</tr>
			<tr>
				<td>map</td>
				<td>text/html</td>
				<td>Ausgabe als Google Maps Karte (HTML mit Verwendung von Javascript zur Einbindung eines KML-Layers basierend auf der Rückgabe bei format=kml).</td>
				<td></td>
			</tr>
		</table>
		
		
		
		<h2>Dokumentation</h2>
		Hier findet sich die ausführliche Dokumentation zum Download als PDF
		<br/>
		<a href="dokumentation.pdf">Dowload starten</a>
		
		
		
		<h2>Projekt auf Google Code</h2>
		<a href="http://code.google.com/p/event-los/source/browse/#svn%2Ftrunk%2Ftest1%253Fstate%253Dclosed">Link</a>
		
		<h2>Javadoc zum Projekt</h2>
		<a href="../doc/index.html">Link</a>
	</body>
	</font>
</html>